home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 010a / palert24.zip / PALERT.DOC < prev    next >
Text File  |  1991-10-22  |  14KB  |  416 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                                   P A L E R T
  17.  
  18.                                       by
  19.  
  20.                                   Patri-Soft
  21.  
  22.  
  23.  
  24.                                   Version 2.4
  25.                                   October 1991
  26.  
  27.  
  28.  
  29.  
  30.                        Support BBS --  Patriquin's BBS
  31.                                        714-352-2825 (DATA)
  32.                                        714-352-2820 (Voice)
  33.                                        714-352-1527 (FAX)
  34.  
  35.  
  36.  
  37.                           Copyright 1991 by Patri-Soft
  38.  
  39.  
  40.  
  41.                         Table of Contents
  42.  
  43.  
  44.       What is PALERT. . . . . . . . . . . . . . . . . . . . . .   1
  45.       Features  . . . . . . . . . . . . . . . . . . . . . . . .   2
  46.       Command Mode Parameters . . . . . . . . . . . . . . . . .   3
  47.       Examples  . . . . . . . . . . . . . . . . . . . . . . . .   5
  48.       Registering PALERT. . . . . . . . . . . . . . . . . . . .   7
  49.       Registration Form . . . . . . . . . . . . . . . . . . . .   8
  50.       Problems and Maintenance. . . . . . . . . . . . . . . . .   9
  51.       Other Utilities . . . . . . . . . . . . . . . . . . . . .   9
  52.  
  53.  
  54.  
  55.  
  56.       What is PALERT
  57.       --------------
  58.  
  59.       PALERT is a utility program to help you avoid unexpectedly
  60.       running out of disk space and/or memory.  Many times application
  61.       programs terminate abnormally or disallow you from completing a
  62.       function because of insufficient disk space or memory.
  63.       Sometimes, this may cause you to lose valuable work time and
  64.       sometimes causes data to be lost. PALERT watches your disk space
  65.       and warns you when space is getting low.
  66.  
  67.       PALERT lets you specify your disk space needs and then watches
  68.       the disk until that limit is reached.  It then warns you of
  69.       the situation and lets you take appropriate action.  PALERT
  70.       is implemented as a standard DOS command that may be used
  71.       by itself or from a DOS batch command file.
  72.  
  73.       Implement PALERT before starting any application or program
  74.       where sufficient disk space is critical.  PALERT will save
  75.       you time and money.
  76.  
  77.       Features:
  78.       ─────────
  79.  
  80.         **  Checks disk space whenever you want to.
  81.  
  82.         **  Checks available memory
  83.  
  84.         **  Can let applications know what day is today.
  85.  
  86.         **  Can trigger other commands based on insufficient
  87.             disk space and/or memory
  88.  
  89.         **  Many features to customize messages and actions
  90.  
  91.         **  Easy to install and use
  92.  
  93.                                                                 Page  2
  94.  
  95.       Command Mode Parameters
  96.       -----------------------
  97.  
  98.       PALERT allows several command parameter switches to be specified
  99.       to customize the process.  All these parameters are optional. The
  100.       command format and switch parameters are described below.  A quick
  101.       review of command parameters is always available by entering the
  102.       PALERT command with the /H parameter.
  103.  
  104.       COMMAND FORMAT:
  105.  
  106.       PALERT [drive:]    [ (/ switches) ]
  107.  
  108.  
  109.       [drive:]  If desired you may specify the drive where space is to
  110.                 be checked.  If the drive letter is not specified, the
  111.                 current defualt drive is checked. PALERT will also check
  112.                 multiple drives.  For example: PALERT CDE will check
  113.                 drives C, D, and E and give you a cumulative display.
  114.                 (This also works with all parameters)
  115.  
  116.  
  117.       /Wppp     Warn the user and set DOS ERRORLEVEL flag if the
  118.                 percentage of free disk space is less than the ppp value
  119.                 specified.
  120.  
  121.                 /W5 indicates to warn user if less than 5 percent of
  122.                 disk space is free.
  123.  
  124.  
  125.       /Bbbbb    Warn the user and set DOS ERRORLEVEL flag if the
  126.                 number of kilobytes of free disk space is less than the
  127.                 bbbb value specified.  The maximum value of bbbb is
  128.                 32767.
  129.  
  130.                 /B3000 indicates to warn the user if less than
  131.                 3,000,000 characters of disk free space exist.
  132.  
  133.       /D        Return an errorlevel according to the Day. PALERT will
  134.                 return an errorlevel for the day only when the /D
  135.                 parameter is specified.  The errorleves returned are:
  136.                 0 - Sunday      3 - Wedensday   6 - Saturday
  137.                 1 - Monday      4 - Thursday
  138.                 2 - Tuesday     5 - Friday
  139.  
  140.                 A sample .BAT files is included to demonstrate how to
  141.                 use this capability.
  142.  
  143.       /Lxxx     Warn when available memory is less than xxx. Sets the
  144.                 DOS ERRORLEVEL flag to 2.
  145.  
  146.                 PALERT /L400 will warn you if memory is below
  147.                 400,000 bytes.
  148.                                                                   Page 3
  149.  
  150.  
  151.       /E        SupprEss the disk check and check only memory
  152.  
  153.       /N        A scale that shows used disk space is normally
  154.                 shown to the user each time PALERT is run.  To
  155.                 prevent the scale from being displayed, enter the
  156.                 /N parameter.
  157.  
  158.  
  159.       /M        Messages are normally shown to indicate the Total,
  160.                 Used, and Free disk space.  If these messages are
  161.                 not normally wanted, enter the /M parameter.  Then they
  162.                 will only be issued when the user is warned.
  163.  
  164.  
  165.  
  166.       /P        After the user is warned of insufficient disk/memory
  167.                 space, PALERT will pause to make sure the user is aware
  168.                 of the situation.  To avoid this pause enter /P.
  169.  
  170.  
  171.       /S        When PALERT detects insufficient disk/memory space it
  172.                 sounds an alert to the user.  To avoid this noise
  173.                 specify the /S parameter.
  174.  
  175.  
  176.       /C        Each time PALERT is run it reminds the user that HELP is
  177.                 available by entering the /H parameter.  To avoid this
  178.                 message enter /C.
  179.  
  180.  
  181.       /H        PALERT contains internal help that is available at
  182.                 any time by using the /H parameter.
  183.  
  184.       PALERT automatically checks the system date to determine if it is
  185.       current or not.  If it is not, PALERT allows you to set it
  186.       correctly.
  187.  
  188.                                                                 Page  4
  189.  
  190.  
  191.       Examples:
  192.  
  193.       1.  Warn user when less than 1,000,000 characters of disk
  194.           space is available.
  195.  
  196.               ===> PALERT C: /B1000 /C
  197.  
  198.  
  199.       2.  Warn user when less than 5 percent of disk space is
  200.           available.
  201.  
  202.               ===> PALERT C: /W5 /C
  203.  
  204.  
  205.       3.  Warn user when less than 300K of memory is available:
  206.  
  207.               ===> PALERT /L300
  208.  
  209.  
  210.       4.  DOS batch file that will check disk space each time
  211.           the LOTUS command is entered.  If the desired disk space is
  212.           not available stop the command.
  213.  
  214.             PALERT /b2000/m
  215.             if errorlevel 1 goto error
  216.             LOTUS
  217.             goto end
  218.             :error
  219.             ECHO command terminated due to insufficient disk space
  220.             :end
  221.  
  222.           This sample DOS batch file may be found in the .ARC file
  223.           that contains this program.  Name=PA123.BAT.
  224.  
  225.       5.  Determine the day by using PALERT /D.
  226.  
  227.                 PALERT /D
  228.                 if errorlevel = 2 goto tue
  229.                 etc....
  230.  
  231.           Sample batch file included, called DAY.BAT
  232.  
  233.                                                                 Page  5
  234.  
  235.  
  236.       Registering PALERT
  237.       ──────────────────
  238.  
  239.       PALERT is distributed under the Shareware concept.  This makes it
  240.       available for anyone to try without obligation.  If you decide it
  241.       is useful and want to keep it, I ask that you register your use
  242.       of it.  This will allow for continued support and maintenance of
  243.       the program and will help to encourage that more quality software
  244.       be made available through this channel.   We require all
  245.       corporate and government users of this utility register their
  246.       copies.
  247.  
  248.       To simply register the program, $10 is requested.  If you would
  249.       like the newest program disk and a copy of the manual send
  250.       $20.  If you would like to register all the Patriquin utilities,
  251.       and receive programs on disk and manuals, send $45.
  252.  
  253.  
  254.       Send registration requests to:
  255.  
  256.                       Patri-Soft
  257.                       P.O. Box 8263
  258.                       San Bernardino, CA   92412
  259.  
  260.  
  261.       The registration charge is a one time fee that entitles you to
  262.       all future versions of the product.  These may either be obtained
  263.       from normal Shareware sources or directly from me.  Any
  264.       organization ordering more than 100 copies is also entitled to
  265.       telephone support and will be given the technical support number.
  266.  
  267.       Following is a form that may be used to register PALERT.
  268.  
  269.                                                                 Page  6
  270.  
  271.                               PALERT Registration
  272.                                  Version 2.4
  273.  
  274.  
  275.       Please Register PALERT to the following person.  We will use ____
  276.       copies  of  the program and have enclosed $____ for each copy to
  277.       be used.
  278.  
  279.       ──────────────────────────────────────────────────────────────
  280.  
  281.       _____ Registration only .............................   $10.00
  282.  
  283.       _____ Registration, program disk and manual..........   $20.00
  284.  
  285.       _____ Registration of all Patriquin Utilities with
  286.                program disks and manuals...................   $45.00
  287.  
  288.       _____ Update of newest Patriquin Utility disk with
  289.                manual.  ...................................   $15.00
  290.  
  291.       ──────────────────────────────────────────────────────────────
  292.  
  293.  
  294.       Name: __________________________________________________
  295.  
  296.       Company: _______________________________________________
  297.  
  298.       Address: _______________________________________________
  299.  
  300.                _______________________________________________
  301.  
  302.       City: ______________________________  State: ___________
  303.  
  304.       Zip:  ______________________
  305.  
  306.       I obtained my copy of PALERT from: ____________________________
  307.  
  308.       If BBS indicate name and number please._________________________
  309.  
  310.       ________________________________________________________________
  311.  
  312.       Please register the software under the following name:
  313.  
  314.       ____________________________________________________
  315.  
  316.               Send to:
  317.                       Patri-Soft
  318.                       P.O. Box 8263
  319.                       San Bernardino, CA  92412
  320.                                                                 Page  7
  321.                           P A L E R T
  322.  
  323.       Problems and Maintenance
  324.       ------------------------
  325.  
  326.       I welcome all comments or enhancement suggestions. Please
  327.       document each item clearly and provide printed examples if
  328.       possible.  Please be sure to include this form with all requests,
  329.       it will help to make sure we can provide you with the best
  330.       possible service.
  331.  
  332.  
  333.       Name: __________________________________________________________
  334.  
  335.       Company: _______________________________________________________
  336.  
  337.       Address: _______________________________________________________
  338.  
  339.                _______________________________________________________
  340.  
  341.       City: __________________________________  State: _______________
  342.  
  343.       Zip: ______________________________
  344.  
  345.       Telephone: _______ / ________________________ (Home / Work)
  346.  
  347.  
  348.       Date: _________________________
  349.  
  350.       Description of problem or enhancement:
  351.  
  352.       ________________________________________________________________
  353.  
  354.       ________________________________________________________________
  355.  
  356.       ________________________________________________________________
  357.  
  358.       ________________________________________________________________
  359.  
  360.  
  361.       Suggested solution:
  362.  
  363.       ________________________________________________________________
  364.  
  365.       ________________________________________________________________
  366.                                                                 Page  8
  367.  
  368.       Program Maintenance:
  369.       --------------------
  370.  
  371.       Version 1.0     August 22, 1986
  372.  
  373.       Version 1.6     January 17, 1987
  374.                         --  Problem with large capacity disks printing
  375.                             incorrect space used percent.
  376.  
  377.       Version 2.0     August 8, 1990
  378.                         --  Added memory check
  379.                         --  Support for cumulative report of mulitple
  380.                             drives
  381.       Version 2.1     January 26, 1991
  382.                         --  Fixed minor bugs experienced by 2 users
  383.       Version 2.3     June 12, 1991
  384.                         --  Fixed problem encountered by users with
  385.                             386 with large hard drives
  386.       Version 2.4     October 22, 1991
  387.                         --added /D
  388.                         --Added invalid date detection
  389.  
  390.  
  391.  
  392.       -----------------------------------------------------------------
  393.  
  394.  
  395.  
  396.       Other Patriquin Utilities:
  397.       --------------------------
  398.  
  399.       PSEARCH  --  Extensive file find and Text search capabilities in
  400.                    a menu driven environment.
  401.  
  402.       PCOPY/PMOVE  --  Complete file copy.move utility that prevents
  403.                 users from accidently losing files by using DOS COPY.
  404.                 Fast file movers are intelligent and move files to
  405.                 different hard disk directories without moving data.
  406.  
  407.       PTOUCH  --  Set date and time values on files specified
  408.                 through command parameters.
  409.  
  410.       PALERT  --  Warn users of insufficient disk space before it
  411.                 causes them problems.
  412.  
  413.       PDAILY  --  Perform any command or batch function only once
  414.                   per day.  Use in AUTOEXEC.BAT file.
  415.  
  416.